home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 079 (1988-11-15)(Ossowski, Stefan)(DE)(PD).zip / Taifun 079 (1988-11-15)(Ossowski, Stefan)(DE)(PD).adf / GiroMan / GiroMan.doc < prev    next >
Text File  |  1988-08-14  |  12KB  |  346 lines
  1.              * GiroMan V3.00 *
  2.               -----------------
  3.  
  4.          Ein Girokontoverwaltungs-Programm
  5.            für den AMIGA (KickStart 1.2)
  6.  
  7.          GiroMan V1.00  PET-Version  © 1980
  8.          GiroMan V2.00  C64-Version  © 1983
  9.          GiroMan V3.00 AMIGA-Version © 1987
  10.  
  11.                 by
  12.  
  13.             ###################
  14.             # Sönke  Netzband #
  15.             # Mozartstraße  5 #
  16.             # 2190 CUXHAVEN 1 #
  17.             # Tel.04721/34777 #
  18.             ###################
  19.  
  20.  
  21.          Dieses Programm ist PUBLIC-DOMAIN.
  22.  
  23.     Also bitte beim Weitergeben an folgende Regeln denken:
  24.  
  25.          1. Dieses File darf nicht verändert werden.
  26.          2. Der Source-Code ist nach eigenen Wün-
  27.             schen änderbar (außer verändern oder
  28.             löschen der CopyRight-Noten).
  29.          3. Bitte nur das komplette Paket weiter-
  30.             geben (Inhalt siehe unten).
  31.  
  32.         Inhalt Paket GiroMan:
  33.         ---------------------
  34.         Sources (DIR)
  35.             Data.h        (Strukturinitialisierungen)
  36.             Giro.c        (Sourcecode)
  37.             Giro.h        (Definieren Globals,Structs)
  38.             MAKEFILE    (Makefile für MANX-MAKE)
  39.             own.lib        (Druckerroutinen Object-Code)
  40.         Daten (DIR)
  41.             GiroDaten    (Daten für einzelne Einträge)
  42.             Index        (Indexdatei für Girodaten)
  43.             MonatDaten    (Daten für monatliche Buchungen)
  44.         .info
  45.         GiroMan V3.00        (GiroMan-Programm)
  46.         GiroMan V3.00.info    
  47.         GiroMan.doc        (Dieses File)
  48.         GiroMan.doc.info
  49.  
  50. ----------------------------------------------------------------------------
  51.  
  52. Programmbeschreibung:
  53. ---------------------
  54. GiroMan V3.00 ist ein Programm, um ständig einen genauen Überblick über sein
  55. Girokonto zu haben. Das mag vielleicht nach nicht viel klingen, aber Dank
  56. einiger Features ist es ein praktisches Hilfsmittel im täglichen Leben. So
  57. kann man z.B. nach bestimmten Einträgen suchen, den Kontostand von einem
  58. beliebigen Tag abfragen, die monatlichen Festposten (Daueraufträge oder Ein-
  59. zugsermächtigungen) mit einer Menü-Anwahl erledigen, einen Ausdruck von
  60. beliebig vielen Tagen (mit Saldoangabe) abrufen oder einzelne Buchungen 
  61. hinzufügen, ändern und löschen. Das Programm unterstützt voll die Intuition-
  62. umgebung, und ist deshalb sehr leicht zu bedienen. Programmiert habe ich
  63. GiroMan V3.00 in 'C' mit dem MANX Aztek-C-Compiler V3.4a.
  64.  
  65.  
  66. Bekannte Fehler von GiroMan V3.00:
  67. ----------------------------------
  68. Bei mir läuft das Programm seit März 1988 ohne einen einzigen Absturz.
  69. Voraussetzung zum korrekten Abauf ist jedoch KickStart Version 1.2.
  70. Ebenso arbeitet das Programm problemlos mit der neuen WorkBench 1.3
  71. zusammen. Über den Ablauf unter KickStart 1.3 kann ich keine Angabe machen.
  72.  
  73.  
  74. !! WARNUNG !!:
  75. --------------
  76. BITTE DAS PROGRAMM NICHT ÜBER EINEN RESET VERLASSEN, DA HIERDURCH DIE INDEX-
  77. DATEI NICHT GESPEICHERT IST UND BEI EINEM SPÄTEREN PROGRAMMABLAUF DIE GIRO-
  78. DATEN NICHT MEHR KORREKT GEFUNDEN WERDEN. AUßERDEM MUß UNTER ALLEN UMSTÄNDEN
  79. DARAUF GEACHTET WERDEN, DAß WÄHREND EINES PROGRAMMABLAUFES DIE DISKETTE
  80. NICHT AUS DEM LAUFWERK GENOMMEN WIRD, DA DIE HAUPTDATEI BIS ZUM BEENDEN DES 
  81. PROGRAMMS STÄNDIG GEÖFFNET BLEIBT. DIE FOLGE KÖNNTE EIN READ/WRITE ERROR AUF
  82. DER DISK WERDEN.
  83.  
  84.  
  85. Installierung von GiroMan V3.00:
  86. --------------------------------
  87.  1. In den CLI gehen
  88.  2. Leere Diskette in df1: legen
  89.  3. Diskette formatieren [format drive df1: name "GiroMan V3.00" noicons]
  90.  4. Formatierte Diskette entnehmen und diese Diskette in df1: legen
  91.  5. Den Ordner 'DATEN' ins RAM kopieren [copy df1:GiroMan/DATEN ram:]
  92.  6. 'GiroMan V3.00' ins RAM kopieren [copy df1:GiroMan/GiroMan#? ram:]
  93.  7. Diese Diskette entnehmen und formatierte Diskette in df1: legen
  94.  8. DATEN-Directory erstellen [makedir df1:DATEN]
  95.  9. 'DATEN' vom RAM nach df1: kopieren 
  96.     [copy ram:(Index|GiroDaten|MonatDaten) df1:DATEN
  97. 10. 'GiroMan'-Dateien vom RAM: nach df1: kopieren [copy ram:GiroMan#? df1:]
  98. 11. CLI verlassen [endcli] 
  99. 12. Starten von 'GiroMan V3.00' wie jedes WorkBench-Programm "Doppelklick"
  100.     oder vom CLI [cd "GiroMan V3.00:"] und [run "GiroMan V3.00]
  101. 13. Beim ersten Start von GiroMan V3.00 werden nur 20 Leereintäge angezeigt
  102.     und der Saldo steht auf 0.00 DM. Man muß nun leider diese 20 Einträge
  103.     über den Menüpunkt GIRODATEN/ÄNDERN (siehe unten) von Hand auf seine
  104.     letzten 20 eigenen Buchungen abändern und den entsprechenden Saldo
  105.     über den Menüpunkt EXTRAS/NEUER SALDO eingeben. Danach muß man die Da-
  106.     ten über den Menüpunkt GIRODATEN/SICHERN abspeichern und GiroMan V3.00
  107.     ist fertig installiert.
  108. ----------------------------------------------------------------------------
  109.  
  110. Bedienung:
  111. ----------
  112. GiroMan V3.00 bietet sechs Menüs, und zwar (von links nach rechts):
  113.  
  114. 1. Programm
  115. 2. GiroDaten
  116. 3. Eintrag
  117. 4. Anzeigen
  118. 5. Extras
  119. 6. MonatsDaten
  120.  
  121.  
  122. Zu 1. -> PROGRAMM:
  123. ------------------
  124.     a) BEENDEN
  125.     ----------
  126.     Das Programm wird beendet.
  127.     Sollte die Index-Datei noch nicht gespeichert sein, macht GiroMan
  128.     über einen Requester darauf aufmerksam.
  129.  
  130.     b) © SNS 1988
  131.     -------------
  132.     CopyRight-Note.
  133.     Darf nicht durch irgentwelche Mittel verändert oder gelöscht werden !
  134.  
  135.  
  136. Zu 2. -> GIRODATEN:
  137. -------------------
  138.     a) HINZUFÜGEN
  139.     -------------
  140.     Zur manuellen Neuaufnahme einer Buchung.
  141.     Die drei unteren Eingabefelder (StringGadgets) öffnen sich, und man
  142.     kann Datum, Bezeichnung und Betrag (bei Minus Buchungen bitte das 
  143.     Vorzeichen nicht vergessen) eintippen. Um die Eingabe zu verlassen,
  144.     braucht bei leerem Datumsfeld nur RETURN gedrückt werden. Danach 
  145.     werden die Neubuchungen automatische nach Datum in die Hauptdatei
  146.     sortiert.
  147.  
  148.     b) SUCHEN
  149.     ---------
  150.     Zum Suchen einer bestimmten Buchung.
  151.     Ein Requester öffnet sich, und man kann das Datum ab dem gesucht
  152.     werden soll und den Suchbegriff selbst eingeben. Gesucht wird nur 
  153.     im Bezeichnungsfeld.
  154.  
  155.     c) SICHERN
  156.     ----------
  157.     Zum Sichern der Indexdatei.
  158.     Nur aktiv, wenn die Hauptdatei verändert wurde.
  159.     (Hinzufügen,Ändern,Löschen)
  160.  
  161.  
  162. Zu 3. -> EINTRAG:
  163. -----------------
  164. Nur aktiv, wenn Buchung auf dem Bildschirm durch Mausklick selek-
  165. tiert wurde. Selektierung wird durch nochmaligen Mausklick gelöscht.
  166.  
  167.     a) DRUCK AB
  168.     -----------
  169.     Druck ab selektierter Buchung.
  170.     Ein Requester öffnet sich, und man kann das Datum eingeben bis
  171.     wann gedruckt werden soll. Außerdem können Papierart und Druck-
  172.     qualität bestimmt werden. Die Druckerroutinen sind in dem Ob-
  173.     jectFile own.lib definiert. Sie bedienen sich des printer.device.
  174.     Es kann also jeder Drucker benutzt werden, für den ein Drucker-
  175.     treiber existiert.
  176.  
  177.     b) SALDO
  178.     --------
  179.     Anzeige des Saldos nach selektierter Buchung.
  180.  
  181.     c) ÄNDERN
  182.     ---------
  183.     Ändern der selektierten Buchung.
  184.     Die drei unteren Eingabefelder (StringGadgets) öffnen sich, und
  185.     man kann Datum, Bezeichnung und Betrag (bei Minus Buchungen bitte
  186.     das Vorzeichen nicht vergessen) ändern. Der Saldo wird automatisch
  187.     neu berechnet.
  188.  
  189.     d) LÖSCHEN
  190.     ----------
  191.     Löschen der selektierten Buchung.
  192.     NACH BETÄTIGEN DES WEITER-GADGETS IST DIE BUCHUNG FÜR IMMER AUS DER
  193.     HAUPT- UND INDEXDATEI ENTFERNT !!
  194.  
  195.  
  196. Zu 4. -> ANZEIGEN:
  197. ------------------
  198.  
  199.     a) ERSTE SEITE
  200.     --------------
  201.     Die ersten Buchungen werden angezeigt.
  202.  
  203.     b) LETZTE SEITE
  204.     ---------------
  205.     Die letzten Buchungen werden angezeigt.
  206.  
  207.     c) AB DATUM
  208.     -----------
  209.     Die Buchungen ab Datum werden angezeigt.
  210.     Es öffnet sich ein Requester in dem man das gewünschte Datum
  211.     eingeben kann.
  212.  
  213.  
  214. Zu 5. -> EXTRAS:
  215. ----------------
  216.  
  217.     a) NEUE DATEI
  218.     -------------
  219.     Eine neue Index- und Hauptdatei wird erstellt.
  220.     GiroMan V3.00 kann maximal 2000 Buchungen aufnehmen. Überschrei-
  221.     tet man diese Anzahl, wird man über einen Requester aufgefordert,
  222.     eine NEUE DATEI zu erstellen. Alles geschieht über einen Dialog,
  223.     sodaß man hier keine Fehler machen kann. Die letzten zwanzig
  224.     Buchungen werden in die neuen Dateien aufgenommen. Die alten Da-
  225.     teien werden NICHT gelöscht, sondern nur umbenannt (Das aktuelle
  226.     Datum wird an die Dateinamen angehängt).
  227.  
  228.     b) NEUES SALDO
  229.     --------------
  230.     Eingabe eines neuen Saldos.
  231.     Wichtig für Neuerstellung einer Datei (Nur bei Installierung
  232.     von GiroMan V3.00). Über den Requester kann ein neues Saldo
  233.     eingegeben werden mit dem das Programm dann weiterrrechnet.
  234.     Damit das neue Saldo korrekt mit abgespeichert wird, muß man
  235.     GiroMan V3.00 jedoch zwingen, die Indexdatei neu abzuspeichern.
  236.     Dies kann man am Besten durch hinzufügen oder ändern einer 
  237.     Buchung erreichen.
  238.  
  239.  
  240. Zu 6. -> MONATSDATEN:
  241. ---------------------
  242.  
  243.     a) ABZIEHEN
  244.     -----------
  245.     Automatische Buchung der monatlichen Festposten.
  246.     Es öffnet sich ein Requester in dem man das gewünschte Datum
  247.     für die automatische Buchung eingeben kann. Die Buchungen
  248.     richten sich nach dem Dateiinhalt von MonatsDaten, die man
  249.     mit dem folgenden Menüpunkt editieren kann. Gibt man hier
  250.     also z.B. als Datum 01.05.89 ein, werden alle Buchungen auto-
  251.     matisch aufgenommen, die in MonatsDaten MAI definiert sind.
  252.     Die Tag- und Jahrangabe sind nur für das Sortieren in der In-
  253.     dexdatei und die Anzeige auf dem Bildschirm relevant, müssen
  254.     aber explizit eingegeben werden.
  255.  
  256.     b) BEARBEITEN
  257.     -------------
  258.     Bearbeiten der monatlichen Festposten (MonatsDaten).
  259.     Ein eigenes Window öffnet sich in dem diverse Gadgets instal-
  260.     liert sind. Die Bedeutung der Gadgets:
  261.  
  262.         ENDE
  263.         ----
  264.         Das Programmteil BEARBEITEN wird beendet.
  265.         Wurden Änderungen an der MonatsDatei gemacht und nicht
  266.         gesichert, macht ein Requester darauf aufmerksam.
  267.  
  268.         VORAUS
  269.         ------
  270.         Es wird einen Monat vorausgeblättert.
  271.  
  272.         ZURÜCK
  273.         ------
  274.         Es wird einen Monat zurückgeblättert.
  275.  
  276.         SICHERN
  277.         -------
  278.         Die MonatsDatei wird gesichert.
  279.  
  280.         EINGABE
  281.         -------
  282.         Eine (mehrere) neue Buchung(en) werden aufgenommen.
  283.         Es öffnet sich ein Requester in dem man die Monats-
  284.         option, Bezeichnung und den Betrag eingeben kann.
  285.         Mit der Monatsoption kann einfach eine Buchung auf
  286.         mehrere Monate geschrieben werden. So ergibt z.B.
  287.         die Eingabe -1, daß die Buchung in jeden Monat mit
  288.         aufgenommen wird. (-2 => jeden 2.Monat, -3 => jedes
  289.         Vierteljahr, -4 => jedes Dritteljahr, -6 => jedes
  290.         Halbjahr). Andere Eingaben oder keine Eingabe werden
  291.         dann nur für den angezeigten Monat interpretiert.
  292.  
  293.         ÄNDERN
  294.         ------
  295.         Ändern (mehrerer) einer selektierten(r) Buchung(en).
  296.         Das Selektieren geschieht wie im Hauptprogramm durch
  297.         Mausklick. Es öffnet sich ein Requester mit den Da-
  298.         ten der selektierten Buchung. Bei der Monatsoption
  299.         bestehen diesmal aber nur zwei Möglichkeiten:
  300.         Entweder man akzeptiert das angezeigte '-Alle', dann
  301.         werden alle Buchungen gleicher Bezeichnung und glei-
  302.         chen Betrages der Monate JAN-DEZ aktualisiert, oder
  303.          man löscht die Monatsoption, dann wird nur die Bu-
  304.         chung des angezeigten Monats aktualisiert.
  305.  
  306.         LÖSCHEN
  307.         -------
  308.         Löschen (mehrerer) einer selektierten(r) Buchung(en).
  309.         Das Selektieren und die Monatsoption funktioniert
  310.         genauso wie beim Menüpunkt MONATSDATEN ÄNDERN.
  311.         Nach Betätigen des 'WEITER' Gadgets ist (sind) die
  312.         Buchung(en) für immer verloren.
  313.  
  314. ----------------------------------------------------------------------------
  315.  
  316. NOTE:
  317. -----
  318. Ich hoffe, daß Ihr GiroMan V3.00 gut gebrauchen könnt. Für diejenigen, die
  319. sich vielleicht nur den Source-Code ansehen wollen: Leider programmiere ich
  320. selten mit Kommentarzeilen, da ich das Konzept eines Programmes schon vor
  321. der eigentlichen Programmierarbeit fertig auf dem Tisch liegen habe, und mir
  322. dadurch die Übersicht über das Programm nicht verloren gehen kann. Seid also
  323. nicht allzu böse.
  324.  
  325. Falls Ihr Verbesserungsvorschläge, Fragen zur Bedienung, positive oder ne-
  326. gative Kritik zu GiroMan V3.00 einzubringen habt, dann schreibt mir doch
  327. bitte an o.g. Adresse. Über Telefon solltet Ihr es lieber nicht versuchen.
  328. Da ich beruflich zur See fahre, bin ich leider nur selten telefonisch zu
  329. erreichen.
  330.  
  331. Falls es meine Freizeit zuläßt werde ich in den nächsten Wochen (MONATEN??)
  332. einige Verbesserungen in GiroMan V3.00 einbauen.
  333.  
  334. z.B.:
  335.  
  336. 1.) Eigene Input-Routine mit Belegung der Funktionstasten zum Speichern
  337.     von 30 Festtexten (fast fertig)
  338. 2.) Änderung des Datei-Handlings (siehe WARNUNG)
  339. 3.) Mal sehen !?
  340.  
  341. Die überarbeitete Version werde ich dann wieder dem PD-Pool spenden.
  342. ----------------------------------------------------------------------------
  343. Bis dann - Sönke.
  344.  
  345. EOF
  346.